home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / e / AmiTCP_beta.readme < prev    next >
Encoding:
Text File  |  1996-10-11  |  11.1 KB  |  239 lines
  1. Short:  Beta AmiTCP mods for Amiga E
  2. Author: jason@fsel.com (Jason R. Hulance)
  3. Type:   dev/e
  4.  
  5. AmiTCP modules for Amiga E
  6. ==========================
  7.  
  8. This is pretty much a beta release of these modules, since I've had no
  9. bug reports on the last version (which was some time ago).  I'm still
  10. in the rather poor position of not actually running AmiTCP myself, so
  11. I am reliant on those who are...
  12.  
  13. The sources are included but, as ever, they are just for reference.
  14. In particular, you shouldn't try compiling the sources as some of the
  15. modules have had to be fiddled with to get unions etc. (and this will
  16. affect not just the module with the fiddle in it, but all those that
  17. use it).
  18.  
  19. The big difference over the last version is that one of the bitfield
  20. operations has been corrected (Wouter's documentation mislead me, but
  21. there's no real excuse for me not testing that bit!), and there is now
  22. some initialisation code.  This was present in the net.lib link
  23. library of the SAS/C version, so I guess it might be pretty important.
  24. The rest of net.lib has not yet been ported to E (unless someone knows
  25. different...).  I may start working on it but, again, I'm hardly the
  26. best person to do this, not having AmiTCP running on my Amiga!
  27.  
  28. To use the initialisation do something like this:
  29.  
  30.   MODULE 'amitcp/init/amitcp_init'
  31.  
  32.   PROC main() HANDLE
  33.     -> AmiTCP: initialise everything
  34.     amitcp_init()
  35.  
  36.     -> Your code
  37.  
  38.   EXCEPT DO
  39.  
  40.     -> Your cleanup code
  41.  
  42.     -> AmiTCP: cleanup everything
  43.     amitcp_cleanup()
  44.   ENDPROC
  45.  
  46. The initialisation code opens the 'bsdsocket' and 'usergroup'
  47. libraries, initialises I/O variables and opens a timer.  It also sets
  48. up various other arrays.  If you want your can just use the bits you
  49. need from the 'amitcp/init' directory.  It should be fairly
  50. self-explanatory.
  51.  
  52. Anyway, the key thing is this: if you use one of the init routines
  53. (e.g., amitcp_init() for the whole lot), then you must make sure you
  54. match it with the corresponding cleanup call (amitcp_cleanup() for
  55. amitcp_init()).  I'd advise that you use the exception handling method
  56. shown above.  Also, your program should *NEVER* use E's CleanUp()
  57. function, as this terminates your program immediately and gives it no
  58. chance to perform its own cleanup.
  59.  
  60. Have fun!
  61.  
  62. Jason  (jason@fsel.com)
  63.  
  64.  
  65. ============================= Archive contents =============================
  66.  
  67. Original  Packed Ratio    Date     Time    Name
  68. -------- ------- ----- --------- --------  -------------
  69.     2184    1113 49.0% 13-Aug-96 08:39:56  AmiTCP.beta.readme
  70.     1220     462 62.1% 11-Aug-96 19:15:16 +socketbasetags.m
  71.      558     303 45.6% 11-Aug-96 19:15:18 +types.m
  72.     1136     597 47.4% 11-Aug-96 19:15:18 +ftp.m
  73.     4512    1398 69.0% 11-Aug-96 19:15:18 +nameser.m
  74.     6078    2697 55.6% 11-Aug-96 19:15:20 +telnet.m
  75.      320     188 41.2% 11-Aug-96 19:15:58 +tftp.m
  76.      626     405 35.3% 11-Aug-96 19:15:04 +charread.m
  77.      396     227 42.6% 11-Aug-96 19:15:20 +socket_inlines.m
  78.      774     415 46.3% 11-Aug-96 19:15:22 +netinfo.m
  79.     2912    1271 56.3% 11-Aug-96 19:15:22 +sana2.m
  80.      136      89 34.5% 11-Aug-96 19:15:22 +sana2specialstats.m
  81.       54      43 20.3% 11-Aug-96 19:15:04 +errno.m
  82.      716     343 52.0% 11-Aug-96 19:15:04 +fcntl.m
  83.      108      82 24.0% 11-Aug-96 19:15:06 +grp.m
  84.      476     289 39.2% 11-Aug-96 19:15:06 +inetd.m
  85.      854     328 61.5% 11-Aug-96 19:21:46 +amitcp_init.m
  86.     1066     610 42.7% 11-Aug-96 19:21:44 +autoinit.m
  87.      384     293 23.6% 11-Aug-96 19:21:44 +dosio_init.m
  88.     1000     625 37.5% 11-Aug-96 19:21:44 +init_usergroup.m
  89.     1490     929 37.6% 11-Aug-96 19:21:44 +timerinit.m
  90.       54      44 18.5% 11-Aug-96 19:15:06 +ios1.m
  91.      700     372 46.8% 11-Aug-96 19:15:22 +usergroup.m
  92.      384     227 40.8% 11-Aug-96 19:15:56 +lineread.m
  93.      662     336 49.2% 11-Aug-96 19:15:58 +if.m
  94.      560     302 46.0% 11-Aug-96 19:15:24 +if_arp.m
  95.      298     198 33.5% 11-Aug-96 19:15:24 +if_dl.m
  96.      252     144 42.8% 11-Aug-96 19:15:24 +if_types.m
  97.     1544     775 49.8% 11-Aug-96 19:15:26 +route.m
  98.      230     115 50.0% 11-Aug-96 19:15:26 +sana2tags.m
  99.      658     320 51.3% 11-Aug-96 19:15:08 +netdb.m
  100.     1430     578 59.5% 11-Aug-96 19:15:26 +in.m
  101.       56      46 17.8% 11-Aug-96 19:15:28 +in_systm.m
  102.     2786    1049 62.3% 11-Aug-96 19:16:00 +ip.m
  103.     1400     620 55.7% 11-Aug-96 19:15:58 +ip_icmp.m
  104.     1688     666 60.5% 11-Aug-96 19:15:28 +ip_var.m
  105.     1112     488 56.1% 11-Aug-96 19:15:30 +tcp.m
  106.      110      74 32.7% 11-Aug-96 19:15:30 +udp.m
  107.      666     403 39.4% 11-Aug-96 19:16:00 +dumprestore.m
  108.      762     448 41.2% 11-Aug-96 19:16:00 +routed.m
  109.      418     247 40.9% 11-Aug-96 19:15:32 +rwhod.m
  110.      690     348 49.5% 11-Aug-96 19:15:32 +talkd.m
  111.     1442     703 51.2% 11-Aug-96 19:16:00 +timed.m
  112.      150     103 31.3% 11-Aug-96 19:15:08 +pwd.m
  113.     1342     588 56.1% 11-Aug-96 19:16:02 +auth.m
  114.      256     175 31.6% 11-Aug-96 19:15:34 +auth_unix.m
  115.     1908     862 54.8% 11-Aug-96 19:16:02 +clnt.m
  116.      410     209 49.0% 11-Aug-96 19:15:36 +pmap_prot.m
  117.      262     144 45.0% 11-Aug-96 19:15:36 +pmap_rmt.m
  118.      102      75 26.4% 11-Aug-96 19:15:36 +rpc.m
  119.      864     411 52.4% 11-Aug-96 19:16:00 +rpc_msg.m
  120.     1320     582 55.9% 11-Aug-96 19:15:38 +svc.m
  121.       82      69 15.8% 11-Aug-96 19:15:38 +types.m
  122.     2126     725 65.8% 11-Aug-96 19:15:38 +xdr.m
  123.      842     383 54.5% 11-Aug-96 19:15:40 +bootparam_prot.m
  124.     3432    1240 63.8% 11-Aug-96 19:15:40 +nfs_prot.m
  125.     2092     713 65.9% 11-Aug-96 19:15:42 +nlm_prot.m
  126.     1934     894 53.7% 11-Aug-96 19:15:42 +rex.m
  127.      472     223 52.7% 11-Aug-96 19:15:42 +rnusers.m
  128.      532     291 45.3% 11-Aug-96 19:15:44 +rquota.m
  129.     1154     370 67.9% 11-Aug-96 19:15:44 +rstat.m
  130.      628     289 53.9% 11-Aug-96 19:15:44 +sm_inter.m
  131.      336     195 41.9% 11-Aug-96 19:15:44 +spray.m
  132.     2874    1028 64.2% 11-Aug-96 19:16:02 +yp.m
  133.      292     182 37.6% 11-Aug-96 19:15:46 +yppasswd.m
  134.     2092     844 59.6% 11-Aug-96 19:15:08 +stdio.m
  135.     1278     624 51.1% 11-Aug-96 19:15:46 +errno.m
  136.     1116     542 51.4% 11-Aug-96 19:15:48 +ioctl.m
  137.      930     414 55.4% 11-Aug-96 19:15:48 +param.m
  138.     2454    1093 55.4% 11-Aug-96 19:15:48 +socket.m
  139.      986     422 57.2% 11-Aug-96 19:15:50 +stat.m
  140.     2540    1179 53.5% 11-Aug-96 19:15:50 +syslog.m
  141.      604     291 51.8% 11-Aug-96 19:16:02 +time.m
  142.      906     413 54.4% 11-Aug-96 19:15:50 +types.m
  143.       88      67 23.8% 11-Aug-96 19:15:10 +utime.m
  144.      402     203 49.5% 11-Aug-96 19:15:56 +utmp.m
  145.      344     200 41.8% 12-Aug-96 07:07:28 +bitfield.m
  146.      228     170 25.4% 12-Aug-96 07:07:40 +setprogname.m
  147.     1303     436 66.5% 18-Mar-96 17:09:40 +socketbasetags.e
  148.      190     122 35.7% 18-Mar-96 17:10:24 +types.e
  149.      877     422 51.8% 11-Aug-96 12:37:06 +ftp.e
  150.        0       0  0.0% 07-Mar-96 19:11:06 +inet.e
  151.     3394     947 72.0% 24-Mar-96 19:19:04 +nameser.e
  152.     4661    1645 64.7% 11-Aug-96 12:44:00 +telnet.e
  153.      289     213 26.2% 09-Mar-96 21:14:14 +tftp.e
  154.        0       0  0.0% 06-Mar-96 20:33:08 +bsdsocket.e
  155.      713     350 50.9% 24-Mar-96 18:37:08 +charread.e
  156.      471     222 52.8% 24-Mar-96 20:10:38 +socket_inlines.e
  157.      832     398 52.1% 24-Mar-96 19:18:32 +netinfo.e
  158.     3016    1120 62.8% 10-Mar-96 17:01:46 +sana2.e
  159.      126      85 32.5% 10-Mar-96 17:05:14 +sana2specialstats.e
  160.       41      41  0.0% 24-Mar-96 18:25:26 +errno.e
  161.      665     283 57.4% 11-Aug-96 10:39:32 +fcntl.e
  162.      158     120 24.0% 17-Mar-96 18:03:16 +grp.e
  163.      557     307 44.8% 24-Mar-96 19:30:32 +inetd.e
  164.      596     226 62.0% 11-Aug-96 19:19:40 +amitcp_init.e
  165.     1063     490 53.9% 11-Aug-96 19:19:40 +autoinit.e
  166.      436     267 38.7% 11-Aug-96 19:19:40 +dosio_init.e
  167.     1300     609 53.1% 11-Aug-96 19:19:40 +init_usergroup.e
  168.     2078     849 59.1% 11-Aug-96 19:19:40 +timerinit.e
  169.       43      43  0.0% 06-Mar-96 19:16:36 +ios1.e
  170.      914     419 54.1% 24-Mar-96 19:18:12 +usergroup.e
  171.      530     288 45.6% 17-Mar-96 18:14:00 +lineread.e
  172.      758     373 50.7% 24-Mar-96 20:10:08 +if.e
  173.      510     277 45.6% 11-Mar-96 19:24:12 +if_arp.e
  174.      310     209 32.5% 17-Mar-96 18:36:28 +if_dl.e
  175.      284     133 53.1% 11-Mar-96 19:36:26 +if_types.e
  176.     1303     666 48.8% 24-Mar-96 15:42:46 +route.e
  177.        0       0  0.0% 11-Mar-96 20:04:52 +sana2errno.e
  178.      249     117 53.0% 11-Mar-96 20:07:42 +sana2tags.e
  179.      677     289 57.3% 06-Mar-96 20:45:56 +netdb.e
  180.     1589     558 64.8% 24-Mar-96 19:17:44 +in.e
  181.       55      55  0.0% 17-Mar-96 18:47:24 +in_systm.e
  182.     2371     856 63.8% 17-Mar-96 18:55:42 +ip.e
  183.     1459     582 60.1% 24-Mar-96 20:18:44 +ip_icmp.e
  184.     1209     487 59.7% 24-Mar-96 20:11:08 +ip_var.e
  185.      732     350 52.1% 24-Mar-96 19:26:14 +tcp.e
  186.       92      73 20.6% 12-Mar-96 19:45:06 +udp.e
  187.      857     483 43.6% 24-Mar-96 18:58:12 +dumprestore.e
  188.      708     412 41.8% 11-Aug-96 12:46:30 +routed.e
  189.      390     240 38.4% 13-Mar-96 21:31:48 +rwhod.e
  190.      629     332 47.2% 13-Mar-96 21:36:30 +talkd.e
  191.     1060     489 53.8% 11-Aug-96 12:47:22 +timed.e
  192.      211     129 38.8% 17-Mar-96 19:31:28 +pwd.e
  193.     1366     542 60.3% 24-Mar-96 19:24:48 +auth.e
  194.      304     207 31.9% 17-Mar-96 19:39:46 +auth_unix.e
  195.     1949     740 62.0% 17-Mar-96 19:45:28 +clnt.e
  196.        0       0  0.0% 14-Mar-96 19:36:12 +gst.e
  197.        0       0  0.0% 14-Mar-96 19:36:44 +pmap_clnt.e
  198.      347     176 49.2% 24-Mar-96 19:13:32 +pmap_prot.e
  199.      294     172 41.4% 24-Mar-96 20:11:58 +pmap_rmt.e
  200.       97      84 13.4% 14-Mar-96 19:44:50 +rpc.e
  201.      780     386 50.5% 17-Mar-96 19:54:24 +rpc_msg.e
  202.     1441     508 64.7% 17-Mar-96 20:00:32 +svc.e
  203.        0       0  0.0% 14-Mar-96 20:02:38 +svc_auth.e
  204.       80      74  7.5% 17-Mar-96 19:51:26 +types.e
  205.     2447     707 71.1% 24-Mar-96 20:16:46 +xdr.e
  206.      869     352 59.4% 24-Mar-96 19:12:08 +bootparam_prot.e
  207.        0       0  0.0% 18-Mar-96 17:49:14 +klm_prot.e
  208.        0       0  0.0% 18-Mar-96 17:49:28 +mount.e
  209.     3047     982 67.7% 24-Mar-96 19:24:26 +nfs_prot.e
  210.     1668     546 67.2% 24-Mar-96 19:24:00 +nlm_prot.e
  211.     2075     799 61.4% 18-Mar-96 19:33:18 +rex.e
  212.      452     214 52.6% 18-Mar-96 19:36:58 +rnusers.e
  213.      446     256 42.6% 18-Mar-96 19:42:04 +rquota.e
  214.     1068     324 69.6% 19-Mar-96 20:19:04 +rstat.e
  215.      574     259 54.8% 24-Mar-96 11:27:56 +sm_inter.e
  216.      309     181 41.4% 24-Mar-96 11:30:24 +spray.e
  217.     2847     867 69.5% 24-Mar-96 11:50:32 +yp.e
  218.      310     167 46.1% 24-Mar-96 11:52:24 +yppasswd.e
  219.        0       0  0.0% 06-Mar-96 20:52:06 +stat.e
  220.     1904     762 59.9% 11-Aug-96 12:25:58 +stdio.e
  221.        0       0  0.0% 24-Mar-96 12:01:40 +cdefs.e
  222.      900     422 53.1% 24-Mar-96 12:10:36 +errno.e
  223.        0       0  0.0% 24-Mar-96 12:10:52 +file.e
  224.     1635     569 65.1% 25-Mar-96 17:50:10 +ioctl.e
  225.      662     324 51.0% 24-Mar-96 15:40:08 +param.e
  226.     2132     892 58.1% 24-Mar-96 19:30:34 +socket.e
  227.     1165     445 61.8% 24-Mar-96 19:10:58 +stat.e
  228.     2969     857 71.1% 11-Aug-96 12:49:08 +syslog.e
  229.      593     290 51.0% 24-Mar-96 19:11:46 +time.e
  230.      859     359 58.2% 24-Mar-96 19:04:16 +types.e
  231.        0       0  0.0% 06-Mar-96 21:21:58 +syslog.e
  232.        0       0  0.0% 24-Mar-96 18:08:54 +unistd.e
  233.      123     100 18.6% 24-Mar-96 18:09:52 +utime.e
  234.      491     239 51.3% 17-Mar-96 20:18:18 +utmp.e
  235.      388     185 52.3% 12-Aug-96 07:08:06 +bitfield.e
  236.      315     207 34.2% 12-Aug-96 07:08:00 +setprogname.e
  237. -------- ------- ----- --------- --------
  238.   158892   68629 56.8% 04-Oct-96 18:40:00   168 files
  239.